gempy.add_orientations

gempy.add_orientations(geo_model: GeoModel, x: Sequence[float], y: Sequence[float], z: Sequence[float], elements_names: Sequence[str], pole_vector: Sequence[ndarray] | ndarray | None = None, orientation: Sequence[ndarray] | ndarray | None = None, nugget: Sequence[float] | None = None) StructuralFrame[source]

Add orientation data to the geological model.

This function adds orientation data to the specified geological elements in the model. The orientation can be provided directly as pole vectors or as orientation angles (azimuth, dip, polarity). Optional nugget values can also be specified for each orientation point.

Parameters:
  • geo_model (GeoModel) – The geological model to which the orientations will be added.

  • x (Sequence[float]) – Sequence of x-coordinates for the orientation points.

  • y (Sequence[float]) – Sequence of y-coordinates for the orientation points.

  • z (Sequence[float]) – Sequence of z-coordinates for the orientation points.

  • elements_names (Sequence[str]) – Sequence of element names corresponding to each orientation point.

  • pole_vector (Optional[Union[Sequence[np.ndarray], np.ndarray]]) – Sequence of pole vectors for each orientation point. If is np.ndarray, it should have shape (n, 3).

  • orientation (Optional[Union[Sequence[np.ndarray], np.ndarray]]) – Sequence of orientation angles for each orientation point. If is np.ndarray, it should have shape (n, 3).

  • nugget (Optional[Sequence[float]]) – Sequence of nugget values for each orientation point. If not provided, a default value will be used for all points.

Returns:

The updated structural frame of the geological model.

Return type:

StructuralFrame

Raises:

ValueError – If neither pole_vector nor orientation is provided, or if the length of the nugget sequence does not match the lengths of the other input sequences.

Examples using gempy.add_orientations

Unknown Model: Importing Borehole Data and Building a 3D Geological Model with GemPy

Unknown Model: Importing Borehole Data and Building a 3D Geological Model with GemPy